home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / usrlst04.zip / USERS.DOC < prev    next >
Text File  |  1990-04-12  |  5KB  |  115 lines
  1.                                       - 1 -
  2.  
  3.  
  4.                          User Lister v0.4 - Documentation
  5.                          --------------------------------
  6.                         (C)Copyright 1990 - by Joe Farrell
  7.  
  8. Legal Information
  9. =================
  10.  
  11.   As you may have heard before, this is the legal garbage you should know in 
  12. order to run this program.  I guarantee absolutely nothing out of this user
  13. lister program except that it will occupy disk space.  I cannot be held re-
  14. sponsible if it burns down your house.  Please keep in mind this software is
  15. absolutely FREE, no charge, and it's not "Public Domain".  If you find it of
  16. value, GOOD!  I'm not asking for any registration fees of any sort, but if you 
  17. feel your conscience bothering you, you can send a small donation to me at the 
  18. address at the end of this documentation.
  19.  
  20. Introduction
  21. ============
  22.  
  23.   User Lister was created due to the fact that most other user listing
  24. utilities written for Telegard were not quite perfect, and they didn't have
  25. most of the options many SysOps wanted.  User lister is quite the opposite of 
  26. most utilities written today, it's fast, small, and very easy to use.  You
  27. have many options towards what you would like listed.
  28.  
  29. Usage
  30. =====
  31.  
  32.   To execute User Lister, you may simply type "USERS" (without the quotes) and 
  33. it will show a listing of options.  Here is a detailed description of them:
  34.  
  35.     C:\> Users  [Real names, City and State] File1.Asc File2.Ans 
  36.                              
  37. Real names, City and State - Here you may specify either a 0, 1, 2 or 3:
  38.  
  39.   - If you specify a 0, neither Real names nor City and State will be
  40.     included.
  41.   - If you specify a 1, only Real names will be included.                 
  42.   - If you specify a 2, only City and State will be included
  43.   - If you specify a 3, both Real Names, City and State will be included.
  44.                      
  45. File1.Asc - Name of ASCII file to be created.
  46.  
  47. File2.Ans - Name of ANSI file to be created.
  48.                                                                        
  49. Note: Handles will always be included.  You must also specify one of the above
  50. number for each parameter; there are no default values.  
  51.                                                            
  52. IMPORTANT: Also, you need not specify a path for the file to be written; it
  53. will automatically place it in your afiles directory according to what was
  54. read from the Status.Dat file.
  55.  
  56.  
  57.                                      - 2 -
  58.  
  59. Examples
  60. ========
  61.   
  62.   C:\> Users 3 0 bullet9.msg
  63.  
  64.   Create a bulletin with Real names, Non-ANSI, and write it to the file   
  65.   "bullet9.msg".
  66.  
  67.   C:\> Users 1 1 bullet11.ans 
  68.  
  69.   Create a bulletin with only Real name, ANSI included, and write it to the
  70.   file "bullet11.msg".
  71.  
  72. New Features and Bug-Fixes
  73. ==========================
  74.  
  75.   Previously (in v0.1 and v0.2), User Lister only created one file at a time,
  76. first Ascii (the non-Ansi bulletin), then you would have to re-enter another
  77. command line to output an Ansi bulletin also.  Well, that is obviously fixed  
  78. in this version.  Also, a few bugs were fixed, and things were cleaned up a  
  79. little.  (Read in the "Technical Information" section for details on bug-    
  80. fixes.)  In this version, you can also re-direct the output of the status of
  81. file creation via Gateway.  (If you don't understand this, don't worry!  It's 
  82. not any big thing.)
  83.  
  84. Technical Information
  85. =====================
  86.  
  87.   User Lister was written in Turbo C, and I used the TGREC.H header file for
  88. all file structures.  It originally started as a program to only write user
  89. names, but I decided to make it support real names, city and state. In pre-
  90. vious versions, there was a "Fix" parameter that you could specify at the end
  91. of the command line that would apparently correct the "null" output of the 
  92. Ansi bulletin.  Well, that turned out to be a bug where I used the strcpy()
  93. function improperly.  I just couldn't understand why it would sometimes put
  94. those STUPID messages saying "Now writing Ansi Bulletin: (null) ..." -- I 
  95. hated that!  
  96.  
  97. Credit
  98. ======
  99.  
  100.   I'd like to thank Art Solomon of the Mobius Building BBS for allowing me to
  101. test all my software on his BBS.  I'd also like to thank the Telegard 
  102. Development Team for creating such a perfect BBS software, and for also giving
  103. me a chance to write some utilities that I find worthwhile!
  104.  
  105.   In closing,  I found User Lister to be a great program, and I hope you will.
  106. You can look for updates with upcoming versions.  If you have any questions,
  107. contact me at The Mobius Building BBS (313) 781-0871, or call me voice (313)
  108. 752-5264.  You may also write to me: Joe Farrell
  109.                                      11715 31 Mile Rd.
  110.                                      Romeo, Mich
  111.                                      48065
  112.  
  113.   Thanks for trying User Lister!
  114.  
  115.